home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software Vault: The Gold Collection
/
Software Vault - The Gold Collection (American Databankers) (1993).ISO
/
cdr25
/
mklapi10.zip
/
K83LOOP.DOC
next >
Wrap
Text File
|
1993-05-04
|
4KB
|
101 lines
K83LOOP - test your Marklin K83 decoders and switchpoints
═════════════════════════════════════════════════════════
Copyright 1993 Rob Hamerling
K83LOOP is a simple program to test if your switchpoint decoders
(and the switchpoints themselves) are working properly. All switches
in a specified range are switched forward ('branch-off') and backward
('straight') and switched off with a certain wait-time between these
commands. This wait-time can be specified.
The COM-ports to which the Marklin Interface is supposed to be connected
can be specified as well.
Deliverables:
════════════
There are 3 versions of K83LOOP, all with the same functionality:
K83LOOP.EXE - DOS
K83LOOP2.EXE - 16-bits version for OS/2 1.3, 2.0 or higher
K83LOOP3.EXE - 32-bits version for OS/2 2.0 or higher
Command parameters
══════════════════
The following parameters can be specified with execution of K83LOOP (all
variants the same) in the following sequence:
K83LOOP 'first' 'last' 'port' 'pause'
first - first switch address to be tested
last - last address to be tested (default 256)
port - COM-port number (default 1)
pause - Wait-time in milliseconds between commands
(default 250)
Note that the 'wait-time' is actually the time a switchpoint gets its
current, until the 'switch-off' command is executed.
Only the first parameter is required. If you start K83LOOP without
parameters, you will be reminded of the parameters!
K83LOOP can be terminated while running with Ctrl-Break.
Sample report:
═════════════
K83LOOP reports its activity on your display. If you call K83LOOP for
example with:
K83LOOP 253 4 2 250
you may see the following report:
switch branch straight switchoff
number time time time
------ ------- ------- -------
253 0.000 0.281 0.531
254 0.781 1.093 1.343
255 1.593 1.843 2.093
000 2.343 2.593 2.843 (note: 000 equivalent of 256)
001 3.093 3.343 3.593
002 3.843 4.093 4.343
003 4.593 4.843 5.093
004 5.343 5.593 5.843
Notes: - times may be rounded to the next timer-tick value!
- 'wrapping' of switchpoint addresses takes place when 'first'
address is higher than 'last'.
Internals
═════════
K83 is a simple application which makes use of the MKLAPI, one of my
other products for programming the Marklin Digital system. MKLAPI is a
'driver' and high level Application Programming Interface (API).
See the MKLAPI package on the international FIDO Bulletin Board
network (in particular the Fernwood OS/2 program collection) for the
latest version.
K83LOOP is written in standard C-language. The source code of K83LOOP
will be available from me, when you register your MKLAPI package!
Feedback
════════
Comments, suggestions and problem reports are welcome. Send written
notes to:
R. Hamerling
Hogelandseweg 67
4132 CV Vianen
The Netherlands
phone: 31.3473.72136 (voice)
Or send a message via the FIDO Bulletin Board network to:
Rob Hamerling at 2:512/4.1098